IBM Books

AIS/MAS/MRS/MSS Configuration Program User's Guide


Starting the Configuration Program

This chapter describes the procedures for starting the configuration program and how to upgrade configuration files created by earlier versions of the program. It consists of the following sections:


Starting the Configuration Program on AIX

Before starting the configuration program, X-Windows and the common desktop environment must be running on the workstation.

To start the configuration program:

  1. Change directories to the directory that contains the configuration program, for example:

    cd /usr/lpp/aixpath (see Table 2 for the specific path)

  2. Enter config & to start the program in the background.

Starting the Configuration Program with AIX NetView/6000

If you have NetView/6000 you can start the configuration program directly from the menu bar. If the network contains routers of different types (for example, 2210 and 6611) or configuration programs of different versions and releases, you can start any configuration program installed on the machine directly from the menu bar.

To use multiple configuration programs, make sure that each configuration program is in a separate subdirectory from the other configuration programs and NetView/6000.

For each configuration program that you want to start from the menu bar:

  1. Create a file in the /usr/OV/registration/C subdirectory that contains the code for the menu bar selection item.

  2. Change the command statement in the file to point to the path of the desired configuration program.

  3. Save the file with a name that indicates the type, version, and release of the configuration program you are starting.

Figure 1 is an example of the code contained in a file named MRSV33 that points to the configuration program in directory /usr/lpp/mrsv33. The _C in the line under MenuBar "Tools" represent the accelerator character for the menu item--the underscored character in the Navigation Window menu bar's Configure option. This character must be in the character string directly to the left of the action, and cannot be duplicated in another menu item.

Figure 1. Netview/6000 Menu File MRSV33

/*
**  Global Tools
*/
Application "2210 MRS Configuration V3R3"
    Description {
         "2210 MRS Configuration V3R3"
    }
    /*
    **  Tools
    */
    MenuBar "Tools"
    {
       "2210 MRS Config Tool V3.3" _C f.action "cfgtool";
    }
    Action "cfgtool"
    {
        Command "/usr/lpp/mrsv33/config";
    }
}

For more information, such as how to create a sub-menu that contains all of the configuration program menu items, refer to the AIX SystemView NetView/6000 V2R1 Programmer's Guide, SC31-7022.


Starting the Configuration Program on Windows

To start the configuration program under Windows, select:

Start | Programs | winfolder | winprogram
 

(See Table 3 for the specific folder name and program name.)


Starting the Configuration Program on OS/2

To start the configuration program under OS/2:

  1. Locate and open the configuration program os2folder folder (see Table 4 for the specific name).

  2. Double-click the configuration program os2program icon (see Table 4 for the specific name) to start the program. The title window for the configuration program displays.

After the Configuration Program Starts

When the program starts, it uses the options defined in the cfg.ini file. If the file does not exist in the configuration program's directory, the configuration program uses default options and creates a new cfg.ini file. To change the options, select Options from the configuration program menu bar. See Changing the Configuration Program Options for the options that you can change.


Upgrading/Migrating Previous-Level Configuration Files

This version of the configuration program cannot use configuration database files with .cdb file extensions (created by earlier versions of the configuration program). You must upgrade to the new version format (.csf file extension). If the only copy of the existing configuration is in the router or is in a binary format (.cfg) file, before starting the migration process you must use the version of the configuration program that created the existing configuration to create configuration database (.cdb) files, as described at "Creating a Configuration Database File or a Configuration Storage File", and then convert the files to .csf format as described at "Converting Configuration Database Files to Configuration Storage Format Files".

If your configuration database files were created by an earlier version of the configuration program, but already have .csf file extensions, go to "Converting a CSF-Format Configuration File to the Latest Release"

Creating a Configuration Database File or a Configuration Storage File

To create a configuration database file using a previous version of the configuration program:

  1. Start the previous version of the configuration program.

  2. Select Configure | Read router configuration to read the existing configuration into the configuration program.

    Another way to read an existing configuration into the program is to select Configure | Communications | Single |Retrieve.

  3. Select either Configure | Save configuration or Save configuration as.

  4. Save the configuration into a file with a .cdb file extension (older format) or with a .csf file extension (newer format).

  5. Continue at Converting Configuration Database Files to Configuration Storage Format Files to convert the configuration contained in the .cdb file into a .csf file.

Converting Configuration Database Files to Configuration Storage Format Files

All configuration database files (.cdb) from prior versions of the configuration program must be converted to the configuration storage format (.csf). You can use the configuration program to do this. It provides a dialog in which you specify which configuration database files you want to convert. Follow these steps to use the conversion program:

  1. Start the Conversion Program.

    AIX

    1. Change to the directory that contains the configuration program (/usr/lpp/aixpath) - see Table 2 for the specific pathname).

    2. Enter converter.
      Note:See "Hardware and Software Requirements for the Configuration Program" for AIX font requirements for the conversion program.

    Windows 95 or Windows NT

    Select:

    Start | Programs | winfolder | Conversion tool
     
    

    (See Table 3 for the specific folder name.)

    OS/2

    1. Locate and open the configuration program folder (os2folder - see Table 4 for the specific folder name).

    2. Double-click the conversion program icon (Converter Program) to start the conversion program.
  2. Enter the directory that contains the database file into the Directory containing CDB/TLV field.
  3. Use the radio buttons to specify whether you want to convert all configurations in the configuration database or only selected configurations. If you are converting only selected configurations, continue with step 4, otherwise go to step 5.
  4. Select the configurations you want to convert from the Convert Configs list.
  5. Specify the directory that will contain the new configuration files (.csf format).
  6. Select Convert!. The program then converts the specified configurations into separate configuration files in the Configuration Storage Directory (CSD).
  7. Follow the procedure at "Converting a CSF-Format Configuration File to the Latest Release" to upgrade these new .csf files for compatibility with the latest release of the configuration program.

Converting the ELAN Type Link Value File to MSS V1 R2.2 from an Earlier Release

The ELAN Type Link Value Definition File (cfg.tlv) contains any user changes to the standard TLV definitions. This file only needs to be migrated if the standard definitions were changed in an earlier release. You can use the conversion program to do this. It provides a dialog in which you specify the ELAN Type Link Value Definition (cfg.tlv) that you want to convert. Do the following steps to use the conversion program:

  1. Locate the ELAN Type Link Value Definition File (cfg.tlv) for the release from which you are migrating. This file is in the program installation directory.
  2. Start the conversion program.

    AIX

    1. Change to the directory that contains the configuration program (/usr/lpp/aixpath) - see Table 2 for the specific pathname).

    2. Enter converter.
      Note:See "Hardware and Software Requirements for the Configuration Program" for AIX font requirements for the conversion program.

    Windows 95 or Windows NT

    Select:

    Start | Programs | winfolder | Conversion tool
     
    

    (See Table 3 for the specific folder name.)

    OS/2

    1. Locate and open the configuration program folder (os2folder - see Table 4 for the specific folder name).

    2. Double-click the conversion program icon (Converter Program) to start the conversion program.
  3. Enter the directory that contains the TLV file into the Directory containing CDB/TLV field.
  4. Select the TLV file that you want to convert using the Convert Configs list.
  5. Specify the directory that will contain the new TLV file. This directory must be the current release program installation directory.
  6. Select Convert!. The program then converts the specified TLV file.
  7. Follow the procedure at "Converting a CSF-Format Configuration File to the Latest Release" to upgrade these new .csf files for compatibility with the latest release of the configuration program.

Converting a CSF-Format Configuration File to the Latest Release

To convert a configuration file that is already in .csf format for use by the current configuration program:

  1. Start the latest version of the configuration program.

  2. Select Configure | Open configuration. Select the configuration from the Available Configurations list.

  3. Select Open. The configuration program asks if you want to upgrade the configuration to the current version.

  4. Select Configure | Save configuration as to save the configuration to a new file with a new name. Saving the configuration with a new name allows you to keep a copy of the existing configuration file for possible future use.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]